Update dependency org.jetbrains.dokka:dokka-gradle-plugin to v2 #207
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
0.10.1->2.0.0Release Notes
Kotlin/dokka (org.jetbrains.dokka:dokka-gradle-plugin)
v2.0.0: 2.0.0Dokka 2.0.0 focuses on simplifying configuration and preparing for support of future Kotlin language features. Key highlights include:
More details about each of the changes below. See Dokka 2.0.0 milestone for the list of all changes.
Dokka's Gradle plugin v2 based on Dokkatoo
Dokka 2.0.0 introduces significant improvements to Dokka Gradle plugin, aligning more closely with Gradle best practices:
Changes from Dokka 2.0.0-Beta
dokkaPublicationDirectorytobasePublicationsDirectory(#3876)dokkaModuleDirectory, and mark as internal (#3880)dokkaGenerateondokkaGenerateModule*(#3920)Dokka's K2 analysis
Dokka 2.0.0 introduces K2 analysis, which is currently in an experimental stage. Dokka's K2 analysis leverages Kotlin's K2 compiler frontend for analysing code and uses the same shared Analysis API, which is used in IntelliJ IDEA’s K2 mode. The output with K2 analysis should mostly match that of K1 analysis, but there may be minor differences. We are actively working towards stabilizing K2 analysis and are planning to enable K2 analysis by default in future.
To opt in to Dokka's K2 analysis, add the following flag to your project's
gradle.propertiesfile:org.jetbrains.dokka.experimental.tryK2=trueKnown limitations:
We would greatly value your feedback if you encounter any of these limitations.
Potential differences between the outputs of K1 and K2:
While the output of K2 analysis aims to align with K1, there are some differences to be aware of:
HTML format
Dokka 2.0.0 introduces some changes to HTML output. We updated the structure of some elements and classes, particularly in the navigation and sidebar, to improve accessibility and simplify maintenance. These changes only affect you if you previously customized Dokka styles.
navigation--innerandnavigation-title.versions-dropdownto make them more accessible.navigation-controls--homepageto improve consistency. For example, it’s now callednavigation-controls--btn_homepage.For more information, see the pull request.
The easiest way to update your current templates is to adjust the new templates to your needs.
Bugfixes
Other changes
Feedback
We would appreciate your feedback!
Full Changelog: Kotlin/dokka@v1.9.20...v2.0.0
v1.9.20: 1.9.20General bugfixes
sealedkeyword in signatures (#2994)innerkeyword in Kotlin signatures (#2793)@paramtag not working with type parameters (#3199)HTML format
Runners
Gradle Plugin
Maven Plugin
dokka:helpbeing absent (#3035). Thanks to @aSemy!CLI runner
sourceRootsconfiguration option (#2571)Plugin API
Other:
wasm-jsandwasm-wasitargets introduced in Kotlin 1.9.20 are supported (#3310)See Dokka 1.9.20 milestone for the list of all changes.
v1.9.10: 1.9.10General
HTML format
Gradle
Java
v1.9.0: 1.9.0General improvements
HTML format
This release is packed with enhancements and bugfixes that make your API reference docs mobile-friendly!
You may find it a weird direction for improvement — we were just as surprised to find that almost 1/4 of Standard Library's API reference traffic is coming from mobile devices. Thanks to the Kotlin Website team, who contributed these improvements, Dokka now provides a solid experience to such visitors.
Improvements:
Bugfixes
Java interoperability
Javadoc format
@author,@sinceand@returntags (#1770). Thanks to @irina-turova!Other
Known problems
Some Multiplatform Gradle 8 projects might experience build failures when resolving native/platform dependencies. Please, see #3153 for more details and workarounds.
Breaking changes
This release introduces some breaking changes that are expected to affect only a fraction of Dokka users.
HTML
Note: this section only applies to those customizing Dokka's HTML format by overriding styles or HTML templates. If you are not doing any customizations, you may skip this section.
To lay a solid foundation to making the HTML format responsive, some page layouts and many styles had to be changed in a backward-incompatible manner.
If you are overriding
logo-styles.cssto provide your own header logo, please update it to be in line with the new styles - there is significantly less position hardcoding now. See this example for how it can be done.If you are overriding
styles.csswith your own file, please update the baseline styles to the latest, and see if anything is broken. If you get stuck with adapting your styles to the changes, the diff might help.If you are overriding
base.ftlorheader.ftltemplates, please update them to the latest, and adapt your changes.CLI runner
Due to the analysis refactoring needed for the migration to K2 (#3099), the JARs required to run Dokka have slightly changed.
The following JARs are no longer supported or published:
Please, replace them with a single JAR:
Plugin API
An internal refactoring of Dokka's analysis API was much needed for the migration to K2, leading to breaking changes in some cases.
If your Dokka plugin compiles without any problems — you may ignore this information, you are likely not affected.
If something doesn't compile or doesn't work anymore, please see #3099 for more details.
v1.8.20: 1.8.20Improvements
Bugfixes
TypeNotPresentExceptionthrown in projects without KGP (#2890), regression from 1.8.10.Gradle plugin
kotlin-dslplugin (#2702, #2833). Thanks to @aSemy!Plugin API
DokkaConsoleLogger) toPROGRESS(#2871)@InternalDokkaApiannotation (#2904)Infrastructure
Big thanks to @aSemy, @Goooler and @3flex for their valuable contributions and for improving the internal
developer experience when working on Dokka!
buildSrcto a composite build (#2912 by @Goooler)Documentation
README.md(#2940). Thanks to @Goooler!CONTRIBUTING.md(#2952)Security
Other
v1.8.10: 1.8.10Dokka's documentation has been entirely rewritten and can now be found on kotlinlang.org:
Note: Version 1.8.0 was skipped due to a Metaspace memory leak in Kotlin's reflection (KT-56093). Dokka 1.8.10 should be fully compatible with Kotlin 1.8.0.
Improvements
Inheritors,Parameters,See alsoandSamplestabs into the main declaration description (#2688).MembersandMembers & Extensionstabs to class-like declaration pages (#2764).Bugfixes
varproperties being displayed (#2717).DokkaLogger(#2827).Gradle Plugin
NoSuchMethodErrorwhen running under Gradle 8 (#2796).outputDirectoryinput property (#556).moduleVersioninput property (#2799). Thanks to @JavierSegoviaCordoba!MultiModuletasks (#2806). Thanks to @TWiStErRob!Javadoc
javadoc.jarproduced by Dokka is imported into IntelliJ IDEA / Android Studio (#2734). Thanks to @bomberaya!Plugin API
Infrastructure
Other
jackson-databindto avoid CVE-2022-42003 (#2733). Thanks to @ryanlewis!Jsoupto avoid CVE-2022-36033 (#2772).v1.7.20: 1.7.20This release focuses primarily on improving user experience and HTML format in particular.
Improvements
General
suppressInheritedMembersconfiguration property) (#2625)@Deprecateddeclarations such as deprecation message, level and proposed replacement (#2622)Enum's syntheticvalues()andvalueOf()functions (#2650)Javaconstants (#2609)HTML format
Cmd + K/Ctrl + Khotkey for opening search dialog, thanks to @atyrin! (#2633)Javadoc format
varHTML tag, thanks to @atyrin (#2617)Kotlin-as-Java plugin
Gradle runner
kotlin-stdlibdependency, which should fix errors likeModule was compiled with an incompatible version of Kotlin, thanks to @martinbonnin! (#2570)Bugfixes
Markdownelements, where_try_ *this*would be rendered astrythis(#2640)StackOverflowErrorrelated to type-aliased native references (#2664)IllegalStateExceptionthat was caused by using JS's dynamic types (#2645)privatedeclarations were rendered aspublic(#2639)@seetag (#2627)JavaEnum types being rendered asAny(#2647)Javaannotation params (#2593)sourceRootsconfiguration param not handling single.javafiles, thanks to @2017398956! (#2604)dokka-customFormat-exampleproject to use up-to-date logo styles (#2608)Developer experience
Gradle Enterprisebuild scans, thanks to @Goooler! (#2641)GitHub Actionsartifacts to store generated documentation snapshots, thanks to @StefMa! (#2630)Other
v1.7.10: 1.7.10Bugfix release that addresses several blockers and regressions.
General
Kotlin1.7.10Gradle plugin
Kotlinstdlib in plugin dependencies, this should fix errors likeModule was compiled with an incompatible version of Kotlinwhen usingDokka. Thanks to @martinbonnin (#2543)Java sources
Javacode (#2544)Javasources (#2509, #2551, #2350)IntelliJplatformWARN: Attempt to load keymessages that appeared when analyzingJavasources (#2559)v1.7.0: 1.7.0Improvements
General
Kotlin1.7.0,IntelliJPlatform 213Javafields with accessors, now properly interpreted asval/varproperties (#2481, #2532, #2540)@Deprecatedmembers withHIDDENlevel (#2486)HTML format
Javadoc format
Javadocpages generation deterministic (#2479)jQueryto avoid multiple CVEs, thanks to @ToppleTheNun (#1938)GFM format
Kotlin-as-Java plugin
Javaaccess modifiers into function signatures, thanks to @tripolkaandrey (#2510)Gradle runner
dokka-analysisdependencycompileOnly, this should help avoid compatibility problems if different versions ofKotlinare bundled inGradleandDokka(#2521)Gradletasks, thanks to @3flex (#2500)Gradlerunner, thanks to @3flex (#2502)Gradlerunner, thanks to @3flex (#2501)Fixes
General bugfixes
Security
log4j1.2 that came as a transitive dependency (#2488)Plugin API
base.ftltemplate: nowheader.ftl,footer.ftlandpage_metadata.ftlcan be overridden individually (#2432)Other
Thanks to all the contributors!
v1.6.21: 1.6.21This is a bugfix release that mostly enables building documentation for multiplatform projects that utilize
.kliblibraries.Changes
jsoupdependency to avoid CVE-2021-37714 (#2448)Bugfixes
KLIBlibraries for common platform, previously led toERROR CLASSinstead of references in documentation (#2441)v1.6.20: 1.6.20Features
documentedVisibilitiessetting that allows including/excluding any visibility modifier in documentation. This is a more flexible replacement forincludeNonPublic, which has now been deprecated (#2270)HTML format changes
val/varkeywords and default values (#2313)Bugfixes
OutOfMemoryError: Metaspace-related issues for the majority of cases (#2216)@symbol within code blocks in.mdfiles doesn't lead to cropped documents anymore (#2418)isBooleaninstead ofgetBoolean(#2356), thanks to @CharlesG-Branch!Plugin API Changes
General Improvements
package-info.java(#2331), thanks to @ember-rose!<h1>/<h2>/<h3>) in Javadoc (#2345), thanks to @asfalcone!expect-actualkeywords (#2316)Known issues
.kliblibraries may experience problems. There will be a separate1.6.21release that will address this issue shortly.v1.6.10: 1.6.10Changes
Bugfixes
java.util.zip.ZipExceptionfor JS dependencies (#2258)<dl>) used in JavaDocs (#2259)Maintenance
de.undercouch.downloadto 4.1.2 (#2268)kotlinx.coroutinesto 1.6.0 in integration tests (#2276)v1.6.0: 1.6.0Changes:
expectandactualin signaturesv1.5.31: 1.5.31 AlphaChanges:
v1.5.30: 1.5.30 AlphaHighlights of this release are:
@literalis also supported without code tag, thanks @fsladkey@linktag support. Now it supports line breaks!v1.5.0: 1.5.0 AlphaKotlin compiler upgraded to 1.5.0
Fixes:
Make module name optional in CLI (#1850)
Fix line separator issues (#1887)
Fix preserving spaces in Javadoc comments (#1923)
GFM renderer: sanitize line ends (#1936)
Fix rendering html in briefs (#1931)
Fix code blocks on Extension Points page (#1948)
Remove extra dash (#1968)
Don't use older dir from previous runs in versioning (#1963)
Change jekyll links to be .html (#1990)
Fix Gradle plugin application (#2000)
Added features:
Add a supertype for leaf dokka tasks that defines dokkaSourceSets (#1891)
Add ability to specify older versions as a list of files (#1890)
Cachable Gradle task (#1905)
Multilanguage docs inheritance (#1951)
Logging levels in CLI (#1976)
Flatten multi-module structure (#1980)
Special thanks to external contributors: @rnett, @msink, @zsmb13, @rachelcarmena and @hfhbd
v1.4.32: 1.4.32 AlphaFixes:
Added features:
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.